arv-v-dsm/readme.md

virtual-dsm

Virtual DSM in a docker container.

Features

• Upgrades supported
• KVM acceleration
• Graceful shutdown

Usage

Via docker-compose.yml

version: "3"
services:
    dsm:
        container_name: dsm
        image: kroese/virtual-dsm:latest
        environment:
            DISK_SIZE: "16G"
        devices:
            - /dev/kvm
        cap_add:
            - NET_ADMIN                       
        ports:
            - 5000:5000
            - 5001:5001
        volumes:
            - /var/dsm:/storage
        restart: on-failure
        stop_grace_period: 1m

Via docker run

$ docker run --name dsm -it -p 5000:5000 -e "DISK_SIZE=16GB" -v "/var/dsm:/storage" --device=/dev/kvm --cap-add NET_ADMIN --stop-timeout 60 kroese/virtual-dsm:latest

FAQ

• How do I change the size of the virtual disk?

  By default it is 16GB, but you can modify the DISK_SIZE setting in your compose file:

  environment:
    DISK_SIZE: "16G"
  

  To create an empty disk with a maximum capacity of 8 terabyte you would use a value of "8T" for example.

• How do I change the location of the virtual disk?

  By default it resides inside a docker volume, but you can add these lines to your compose file:

  volumes:
    - /home/user/data:/storage
  

  Just replace /home/user/data with the path to the folder you want to use for storage.

• How do I give the container a dedicated IP address?

  By default the container uses bridge networking, and is reachable by the IP of the docker host.

  If you want to give it a seperate IP address, create a macvlan network that matches your local subnet:

  $ docker network create -d macvlan \
      --subnet=192.168.0.0/24 \
      --gateway=192.168.0.1 \
      --ip-range=192.168.0.100/28 \
      -o parent=eth0 vlan
  

  And change the network of the container to vlan in your run command:

   --network vlan --ip=192.168.0.100
  

  This has the advantage that you don't need to do any portmapping anymore.

• How do I change the amount of CPU/RAM?

  By default an amount of 512MB RAM and 1 vCPU is allocated to the container.

  To increase this you can add the following environment variabeles:

  environment:
    CPU_CORES: "4"
    RAM_SIZE: "2048M"
  

• How do I install a specific version of vDSM?

  By default it installs vDSM 7.2, but if you want to use an older version you can add its URL to your compose file:

  environment:
    URL: "https://global.synologydownload.com/download/DSM/release/7.0.1/42218/DSM_VirtualDSM_42218.pat"
  

  You can also switch back and forth between versions this way without loosing your file data.

• What are the differences compared to standard DSM?

  There are only three minor differences: the Virtual Machine Manager package is not available, Surveillance Station does not include any free licenses, and logging in to your Synology account is not supported.

Acknowledgments

Based on an article by JXCN.

Disclaimer

Only run this container on original Synology hardware, any other use is not permitted and might not be legal.