PHP와 Node.js는 모든 환경에 준비되어 있습니다. Python, Ruby, Go, .NET, Java, Flutter는 프로젝트에 필요할 때 사용할 수 있습니다. 원하는 버전을 나란히 설치하고 프로젝트마다 하나를 선택하세요. 시스템 패키지는 일부 패키지와 테스트가 빌드 시 사용하는 라이브러리와 도구를 추가합니다.
프로젝트가 사용하는 버전
python, ruby, go, dotnet과 관련 도구(pip, gem, bundle 등)는 다음 순서로 버전을 선택합니다.
.python-version,.ruby-version,global.json같은 프로젝트 자체의 버전 파일- 패널에서 프로젝트에 지정한 버전
- 기본 버전
패널에서
사이드바의 서버에서 서버를 열고 런타임을 선택하세요. Node.js 카드 다음에 있는 Python, Ruby, Go, .NET, Java, Flutter 카드에는 언어별 섹션이 있습니다.
- 버전 추가는 다른 버전 라인을 설치합니다: Python 3.11
3.14, Ruby 3.23.4, Go 1.251.27, .NET 810, Java 17, 21, 25, Flutter 3.44, 3.47. 해당 라인의 최신 릴리스가 설치되며 몇 분 걸릴 수 있습니다. - 버전의 ⋯ 메뉴는 해당 버전을 기본으로 지정하거나 제거합니다. 기본 버전과 프로젝트가 고정된 버전은 제거할 수 없습니다.
- 프로젝트 버전은 프로젝트를 특정 버전에 고정하거나 기본값으로 되돌립니다.
이 기능에는 rdev 0.2.0-beta.36 이상이 필요하며, 서버가 해당 버전을 실행할 때까지 카드에서 업데이트하라고 안내합니다. .NET은 서버가 rdev 1.0.6 이상을 실행하면 표시되고, Flutter는 서버의 rdev가 이를 포함한 릴리스로 업데이트되면 표시됩니다.
Python 프로젝트
각 Python 프로젝트는 .venv에 자체 가상 환경을 가지므로, 두 프로젝트가 같은 패키지의 서로 다른 버전을 고정할 수 있습니다. 프로젝트를 추가하면 rdev가 가상 환경을 만들고 의존성을 설치합니다. 프로젝트에 uv.lock이 있으면 uv sync, 없으면 requirements.txt 또는 pyproject.toml로 pip를 사용합니다. 개발 서버와 프로젝트의 프로세스는 PATH의 맨 앞에 .venv를 두고 실행됩니다. 설치가 실패해도 프로젝트는 추가되며, rdev는 해당 폴더에서 실행할 명령을 보여줍니다.
.NET
.NET 8, 9, 10은 나란히 설치되며, 프로젝트는 global.json으로 SDK를 선택합니다. 이 파일이 없으면 설치된 가장 최신 SDK가 사용됩니다. 패널이나 rdev lang use로 프로젝트를 특정 버전에 고정하면 이 파일이 자동으로 작성됩니다. .csproj, .fsproj, .sln, .slnx 파일이 있는 프로젝트는 .NET으로 인식되며, 개발 서버는 dotnet watch run으로 시작되므로 저장하면 다시 로드됩니다. SDK 하나당 디스크 약 600MB를 차지합니다.
사이트는 앱 앞단에서 HTTPS로 제공되므로 앱 자체는 일반 HTTP로 수신 대기합니다. 앱이 HTTPS로 리디렉션하거나 절대 링크를 만든다면, 요청이 HTTPS로 들어왔음을 알 수 있도록 전달된 헤더를 켜세요(app.UseForwardedHeaders()와 X-Forwarded-Proto).
SQL Server는 아직 서비스로 제공되지 않습니다. Entity Framework Core(Npgsql 또는 Pomelo 프로바이더)와 함께 PostgreSQL 또는 MySQL을 사용하거나, 다른 곳에서 운영하는 SQL Server에 연결하세요. Tailscale을 통해 자신의 노트북에 있는 SQL Server를 사용할 수도 있습니다. SQL Server에서 TCP/IP를 켜고, 노트북 방화벽에서 Tailscale 네트워크의 1433 포트를 허용한 뒤, 연결 문자열에 노트북의 Tailscale 주소를 넣으세요(Server=100.x.y.z,1433). 노트북이 절전 모드인 동안에는 연결이 끊깁니다.
Java
Java 25, 21, 17은 나란히 설치됩니다. 모두 장기 지원(LTS) 버전이며 기본값은 25입니다. rdev lang install java 25로 설치하세요. 프로젝트는 .java-version 또는 .tool-versions 파일로 버전을 선택합니다. 패널이나 rdev lang use java 21로 프로젝트를 특정 버전에 고정하면 이 파일이 자동으로 작성됩니다. 모든 프로젝트에 JAVA_HOME이 설정됩니다. pom.xml(Maven) 또는 build.gradle(Gradle)이 있는 프로젝트는 Java로 인식됩니다.
mvnw 래퍼가 있는 Spring Boot 프로젝트는 변경된 코드를 약 8초 안에 다시 불러옵니다. src 아래 파일이 바뀌면 rdev가 다시 컴파일합니다. Quarkus는 스스로 다시 불러오는 dev 모드로 실행됩니다.
Java 개발 서버는 메모리를 약 350~700MB 사용하므로, 작은 서버에서는 Java 프로젝트를 한 번에 몇 개만 실행하세요.
Flutter
Flutter 앱은 다른 프로젝트와 똑같이 추가하세요. 클론하거나 Flutter 레시피로 새로 시작하면 되며, rdev는 pubspec.yaml로 앱을 인식합니다. 앱에 웹 타깃(web 폴더)이 있으면 웹 미리보기가 https://<project>.dev.test에서 실행되고 저장할 때 다시 로드됩니다. 첫 빌드에는 30초쯤 걸립니다. 휴대폰, 에뮬레이터, 시뮬레이터에서는 사용자의 컴퓨터에서 실행합니다. 파일 동기화를 켠 상태에서 노트북에서 같은 프로젝트 폴더를 열고 그곳에서 flutter run을 실행하세요. iOS 빌드에는 Xcode가 설치된 Mac이 필요합니다. 웹 타깃이 없는 앱은 개발 서버 없이 추가됩니다. 서버에서는 flutter pub get, flutter analyze, flutter test, flutter build web이 사용자와 에이전트를 위해 동작합니다. Flutter 프로젝트를 추가하려면 rdev 1.4.3 이상이 필요하며, Flutter 레시피는 1.4.2부터 동작합니다.
rdev lang install flutter 3.47로 버전을 설치하세요. Dart가 함께 설치되므로 dart도 동작합니다. 프로젝트는 .fvmrc(FVM이 작성하는 형식) 또는 .tool-versions 파일로 버전을 선택하며, 없으면 패널에서 선택한 버전 또는 기본 버전을 사용합니다. 버전마다 디스크를 약 1GB 사용합니다.
Flutter는 생성하는 일부 파일(.dart_tool, .flutter-plugins-dependencies, ios/Flutter/Generated.xcconfig, android/local.properties)에 해당 컴퓨터 고유의 경로를 기록하므로, 파일 동기화는 이 파일들을 제외합니다. 노트북과 서버가 각자 자기 파일을 보관하며, flutter pub get이 다시 만들어 줍니다. Android 서명 키(key.properties와 키스토어)는 git에 넣지 마세요.
시스템 패키지
시스템 패키지 카드는 시스템 라이브러리와 도구 그룹을 클릭 한 번으로 설치합니다.
| 그룹 | 용도 |
|---|---|
| 빌드 도구 | 컴파일러와 네이티브 확장(Python wheel, Ruby gem, npm 애드온)을 빌드하는 헤더 |
| PostgreSQL 클라이언트 | psql과 데이터베이스 드라이버가 링크하는 라이브러리 |
| MySQL 클라이언트 | mysql과 데이터베이스 드라이버가 링크하는 라이브러리 |
| 이미지 라이브러리 | Pillow나 sharp 같은 이미지 처리 |
| 캔버스 라이브러리 | node-canvas 같은 그리기와 PDF 렌더링 |
| XML 라이브러리 | lxml이나 Nokogiri 같은 XML 파싱 |
| FFmpeg | 비디오와 오디오 변환 |
| Chromium | 브라우저 테스트와 PDF 생성을 위한 헤드리스 브라우저 |
| GitHub CLI | GitHub용 gh 명령: 풀 리퀘스트, 이슈, 릴리스, Actions. 처음 한 번 gh auth login으로 로그인합니다 |
| ICU 라이브러리 | .NET에 필요한 유니코드 및 언어 데이터. 첫 .NET 버전과 함께 자동으로 설치됩니다 |
그룹을 제거하기 전에 먼저 확인을 요청합니다. 해당 그룹을 사용해 빌드하거나 실행하는 프로젝트는 다시 설치할 때까지 동작하지 않을 수 있습니다. 선택한 그룹은 rdev가 환경을 업데이트한 후 자동으로 복구됩니다. Chromium은 환경의 컨테이너 안에서 실행되므로 --no-sandbox로 시작하세요(Puppeteer: args: ['--no-sandbox']).
서버에서
rdev lang list # installed and available versions, defaults and project choices
rdev lang install python 3.13 # the newest 3.13 release
rdev lang default python 3.13
rdev lang use shop python 3.12 # pin a project; rdev lang use shop python default undoes it
rdev lang remove python 3.12
rdev lang install dotnet 10
rdev lang install flutter 3.47 # Flutter with its Dart
rdev system list
rdev system install postgres # build tools, postgres, mysql, images, canvas, xml, ffmpeg, chromium, gh, tauri
rdev system remove postgres
python, pip, ruby, gem, bundle, go, gofmt, dotnet, flutter, dart는 먼저 프로젝트 자체의 버전 파일(.tool-versions, mise.toml, .python-version, .ruby-version, go.mod의 go 줄, global.json, .fvmrc)을 따르고, 그다음 프로젝트에 지정한 버전, 마지막으로 기본 버전을 따릅니다. 설치되지 않은 버전은 설치하라는 메시지와 함께 중단됩니다. 에이전트도 같은 명령어를 사용하며, MCP로는 rdev_lang_list, rdev_lang_install, rdev_lang_project, rdev_system_install을 사용합니다(pg_config not found 같은 네이티브 빌드 실패를 발견한 에이전트가 알맞은 그룹을 설치합니다). pip install이나 gem install이 추가하는 명령어는 python -m, 가상 환경, bundle exec, gem exec로 실행합니다.