# Servers


What is a Server?

A Server is a remote computer where your data is hosted. In most cases, your server is provisioned to you after you purchase the service from cloud service providers like AWS, Namecheap, Bluehost, etc.

Creating a Server

To enable Devpilot communicate and work with your servers, you need to create that connection by providing information like the host, port, username and password to access the server on hosted on your cloud provider.

To create a server, enter the workspace you wish to connect the server to and click on the Add Server button. You would be prompted to provide the following:

  • Server Name: A label to help you remember what server you are connecting to.
  • Provider: The company or cloud service provider.
  • Type: The kind of service the server was purchased with.
  • Script Mode: Devpilot allows you to run commands on your server. The different modes would be explained below:
    • Basic: This mode allows very basic and relatively safe commands to be run on the server. The allowed commands on this mode include: composer, php , npm, nvm, yarn and git.
    • Advanced: This mode adds no script filter by default. Unlike the Basic mode, this mode allows you to set the commands you want to allow on your server.
  • Default Script Level: When creating script filters, you can select the level of severity a command is to ensure only authorized users can execute that command on the server. on the Basic mode however, the default script filters set by Devpilot are used but you can still set the default severity to be applied when authorizing script execution.
  • Host: The remote address of the server you which to connect to.
  • Port: The SSH port to connect to. By default, port 22 is used.
  • Username: The user you want to authenticate as.
  • Authentication Type: The following types are available:
    • Generated Keys: Devpilot would automatically generate an SSH key pair and provide you with the Public Key to add to your server.
    • Uploaded Keys: You would need to upload your existing Private Key that has access to the server.
    • Password: This option allows you input your password instead of using SSH Keys
The Basic Script Mode is usually the best option to select to get your project running in lesser time.

Connecting to Server

After the creation of a server, click on the Refresh Connection button to see if Devpilot is able to connect to your server. If you selected Generated Keys as the authentication type, make sure your follow the instruction on the page accordingly.

Editing a Server

The details can be updated when necessary, but ensure that you refresh the connection after changes are made to ensure that Devpilot is still able to connect to your server.

Deleting a Server

Deleting a server simply disconnects or revokes the access Devpilot has to the remote server. No data on your remote server would be lost. When a server is deleted, all processes on Devpilot connected to the deleted server would stop working. So ensure to update affected apps and processes accordingly.

Found Something Wrong?

Have you found something in the documentation that is confusing or incorrect? Devpilot's documentation is completely open source! Please consider submitting a pull request on GitHub.