Development Environment

Setting up a local development environment for new IT team members.

Core Tools

Homebrew (macOS)

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Git

brew install git          # macOS
sudo apt install git      # Ubuntu/Debian

Node.js (via nvm)

# Install nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

# Restart terminal, then:
nvm install --lts
nvm use --lts

Docker

brew install --cask docker    # macOS

For Linux, follow the official Docker documentation.

IDE — VS Code

Recommended extensions for our stack:

code --install-extension dbaeumer.vscode-eslint
code --install-extension esbenp.prettier-vscode
code --install-extension eamodio.gitlens
code --install-extension ms-azuretools.vscode-docker
code --install-extension gitlab.gitlab-workflow

Recommended .vscode/settings.json

{
  "editor.formatOnSave": true,
  "editor.defaultFormatter": "esbenp.prettier-vscode",
  "editor.tabSize": 2,
  "files.eol": "\n",
  "git.autofetch": true
}

Access to Internal Repositories

1. Generate an SSH key — see the SSH Keys guide
2. Add the key to your profile on GitLab (gitlab.etnetera.cz)
3. Verify access:

ssh -T git@gitlab.etnetera.cz

Expected response:

Welcome to GitLab, @yourname!

Docker Compose — Local Environment

Most projects include a prepared docker-compose.yml:

cd project
cp .env.example .env      # edit as needed
docker compose up -d

INFO

Required .env values can be found in the project's Confluence space or from the tech lead.

New Joiner Checklist

• [ ] Homebrew / apt up to date
• [ ] Git installed and configured (name + email)
• [ ] SSH key generated and added to GitLab
• [ ] Docker Desktop running
• [ ] VS Code with extensions installed
• [ ] VPN access verified
• [ ] Access to Confluence and Jira