code-server/doc/admin/install/digitalocean.md
2019-06-07 14:22:33 -05:00

2.8 KiB

Deploy on DigitalOcean

This tutorial shows you how to deploy code-server to a single node running on DigitalOcean.

If you're just starting out, we recommend installing code-server locally. It takes only a few minutes and lets you try out all of the features.


Use the "Create Droplets" wizard

Open your DigitalOcean dashboard to create a new droplet

  • Choose an image - Select the Distributions tab and then choose Ubuntu
  • Choose a size - We recommend at least 4GB RAM and 2 CPU, more depending on team size and number of repositories/languages enabled.
  • Launch your instance
  • Open a terminal on your computer and SSH into your instance

    example: ssh root@203.0.113.0

  • Once in the SSH session, visit code-server releases page and copy the link to the download for the latest linux release
  • Find the latest Linux release from this URL:
    https://github.com/cdr/code-server/releases/latest
    
  • Replace {version} in the following command with the version found on the releases page and run it (or just copy the download URL from the releases page):
    wget https://github.com/cdr/code-server/releases/download/{version}/code-server-{version}-linux-x64.tar.gz
    
  • Extract the downloaded tar.gz file with this command, for example:
    tar -xvzf code-server-{version}-linux-x64.tar.gz
    
  • Navigate to extracted directory with this command:
    cd code-server-{version}-linux-x64
    
  • If you run into any permission errors when attempting to run the binary:
    chmod +x code-server
    

    To ensure the connection between you and your server is encrypted view our guide on securing your setup

  • Finally start the code-server
    ./code-server
    

    For instructions on how to keep the server running after you end your SSH session please checkout how to use systemd to start linux based services if they are killed

  • Open your browser and visit https://$public_ip:8443/ (where $public_ip is your Digital Ocean instance's public IP address). You will be greeted with a page similar to the following screenshot. Code-server is using a self-signed SSL certificate for easy setup. In Chrome/Chromium, click "Advanced" then click "proceed anyway". In Firefox, click Advanced, then Add Exception, then finally Confirm Security Exception.

NOTE: If you get stuck or need help, file an issue, tweet (@coderhq) or email.