Repository files navigation

Provision Projector using Docker containers asCoderworkspaces with this exampletemplate.

This mimics how it was done in v1, where the IDE is already installed in theimage and Coder provides the Projector server and modifies the script for theinstalled IDE to make it work in Projector.

In v1 we bundled the server with the agent and also had a small patch to forcethe window to resize itself on first launch (included in thebuild directory).

That patch could be applied by compiling from source, however in this example wejust use the official server release.

• Could possibly base off this image:https://github.com/JetBrains/projector-docker
• Instead of installing and patching manually, could use the Projector installerwhich does both for you:https://github.com/JetBrains/projector-installer

The VM you run Coder on must have a running Docker socket and thecoder user must be added to the Docker group:

# Add coder user to Docker groupsudo adduser coder docker# Restart Coder serversudo systemctl restart coder# Test Dockersudo -u coder docker ps

This template provisions the following resources:

• Docker image (built by Docker socket and kept locally)
• Docker container pod (ephemeral)
• Docker volume (persistent on/home/coder)

This means, when the workspace restarts, any tools or files outside of the home directory are not persisted. To pre-bake tools into the workspace (e.g.python3), modify the container image. Alternatively, individual developers canpersonalize their workspaces with dotfiles.

NoteThis template is designed to be a starting point! Edit the Terraform to extend the template to support your use case.

Edit theDockerfile and runcoder templates push to update workspaces.