Install Dev Space Website

You will need to setup a web service with proxy support such as nginx or apache.

Here is a guide to setup nginx.

How To Install Nginx on Ubuntu 20.04 | DigitalOcean

Resources

These will be used later in the install.

Nginx Config

server {
	listen 443 ssl;
	server_name example.com;
	root /usr/share/nginx/www;
		
	location / {
		proxy_pass http://127.0.0.1:5556/;
		proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
		proxy_set_header X-Forwarded-Proto $scheme;
		proxy_set_header Upgrade $http_upgrade;
		proxy_set_header Connection $http_connection;
		proxy_set_header Host $host;
		proxy_cache_bypass $http_upgrade;
	}

	ssl                  on;
    	ssl_certificate      /cert.pem;
    	ssl_certificate_key  /key.pem;
}

Docker Compose

services:
  devspace-web:
    container_name: "devspace-web"
    image: mcr.microsoft.com/dotnet/aspnet:9.0
    command: sh -c "apt-get update && apt-get install -y fontconfig curl && ./DevSpaceWeb"
    environment:
      - ASPNETCORE_ENVIRONMENT=Production
      - LogMode=Error
      - LimitMode=false
    volumes:
      - ./:/app:ro
      - ./Cache:/app/Cache:rw
      - ./Data:/app/Data:rw
      - ./Public:/app/Public:rw
      - ./DataProtection-Keys:/root/.aspnet/DataProtection-Keys:rw
    networks:
      - devspace_web_network
    ports:
      - "127.0.0.1:5556:5556"
    depends_on:
      - devspace-mongodb
    working_dir: /app
    restart: on-failure:3
    healthcheck:
      test: curl -s --fail-with-body http://localhost:5556/api/health || exit 1
      interval: 60s
      timeout: 30s
      retries: 2
      start_period: 15s
  devspace-mongodb:
    container_name: "devspace-mongodb"
    image: mongo:8-noble
    command: --port 5557
    volumes:
      - devspace_mongodb:/data/db
    networks:
      - devspace_web_network
networks:
  devspace_web_network:
    name: devspace_web_network
    driver: bridge
volumes:
  devspace_mongodb:
    name: devspace_mongodb

546B

devspace_nginx.conf

Install Dev Space Website

1. Setup a web service like nginx or apache.

2. Download the devspace_nginx.conf file above.

3. Edit the config file with your domain server_name dev.example.com and your ssl certificate ssl_certificate and ssl_certificate_key if you use Cloudflare you can use the Origin certificate for this.

4. Go to /etc/nginx folder and upload the devspace_nginx.conf file to your sites-enabled folder.

5. Reload nginx using sudo service nginx reload

6. Download the latest version of the website https://cdn.fluxpoint.dev/devspace/web.zip
7. Upload the website files to your server.

8. Open the server terminal and go to the website folder using cd /website for example and run chmod +x DevSpaceWeb to make it executable for the docker container.

9. Run docker compose up -d to start the website.

10. You should see Container devspace-web Started this confirms that it's working.

11. Open up your browser and visit your dev.example.com domain.

Update Dev Space Website

You can easily update the website with a small package which will show up in the info menu if available.

1. Download the update here https://cdn.fluxpoint.dev/devspace/web_update.zip
2. Go to the Dev Space Web folder on your server.

3. Run docker compose down

4. Upload and overwrite the current files with the new ones.

5. Run docker compose up -d

Admin Setup

You will need to setup your instance of Dev Space with certain information and also create an administrator account for your instance.

You will need to contact builderb on Discord to get access to a Fluxpoint Managed email key or you can setup your own email service to send from, some third party services may have limits.