> For the complete documentation index, see [llms.txt](https://docs.faronics.com/faronicsdeploy/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.faronics.com/faronicsdeploy/custom-scripts-powershell-vb-batch/custom-scripts-library/quick-guide-to-self-hosting-custom-scripts.md).

# Quick Guide to Self-Hosting Custom Scripts

## Hosting a Custom Script Using GitHub

Best practice is to self-host your Custom Scripts. To do this, you can use a free repository server such as GitHub, or you could host it on one of your company servers. The following is a guide to hosting a script using GitHub.

1.Create a free account on GitHub <https://github.com/join> (or sign in if you already have a GitHub account).

![](https://3007061244-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MRkQfx_2cLnNNBX1muO%2F-MWzLgLUNko-UI3aX_UK%2F-MWzPdm-GGYlS7gMZg79%2Fimage.png?alt=media\&token=ec275599-3188-4728-8da5-cf22496e5e99)

2\. Create a repository (or use an existing one). Click the green NEW button on the top left of the screen.

![](https://3007061244-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MRkQfx_2cLnNNBX1muO%2F-MWzPnoGzTLz7x3cfoJ0%2F-MWzQI9tq1Q5mUkJ2Tnc%2Fimage.png?alt=media\&token=e1a0e5e9-9aef-4c06-af3d-b46eaf619016)

3\. Create a new script file by clicking c**reating a new file**.

![Creating a New File](https://3007061244-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MRkQfx_2cLnNNBX1muO%2F-MWzXbZDV078KvpLtMBQ%2F-MWzZ4GZyfnDbZTa8p0z%2Fimage.png?alt=media\&token=2988d849-bb76-495c-9a6c-f93fb0b9628d)

4\. Name your script (ensure you have the correct file extension **.ps1** for PowerShell, **.vb** for VBScript, or **.bat** for Batch scripts),  enter your script's contents, then **commit new file**.

![Create the Script and Commit the New File](https://3007061244-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MRkQfx_2cLnNNBX1muO%2F-MWzXbZDV078KvpLtMBQ%2F-MWzZ_USe-pSw7anLEHn%2Fimage.png?alt=media\&token=c5d6c76e-06f5-490d-b48e-72fd83685254)

5\. Access the raw version of your script by clicking the **RAW** button.

![Select Raw to View the Raw Version of the Script](https://3007061244-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MRkQfx_2cLnNNBX1muO%2F-MWzQtd4WmB5a0DXXsIu%2F-MWzVuGuBsthP1Yxo7rU%2Fimage.png?alt=media\&token=3e1a3639-eb3b-472d-843f-a197013cb11e)

6\. Copy the URL for the raw script that appears and save it in a text file for later; you will need this when configuring your custom script in Faronics Deploy.

![Copy the Raw URL](https://3007061244-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MRkQfx_2cLnNNBX1muO%2F-MWzQtd4WmB5a0DXXsIu%2F-MWzX7BSy5_Sz-knLG7X%2Fimage.png?alt=media\&token=3d2a461a-7bb1-4a40-a4c9-07129f5000ee)

{% hint style="success" %}
Your Custom Script is now hosted on GitHub; use the raw URL that you copied in step 6 to configure a Custom Script in Faronics Deploy.
{% endhint %}
