# ControlR

ControlR is an open-source, self-hostable remote control and remote access service for running and managing tasks and commands on your own hardware from a phone, web browser, or other devices. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/4285/controlr

## Description

ControlR is an open-source, self-hostable remote control and remote access service for running and managing tasks and commands on your own hardware from a phone, web browser, or other devices.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

73/100 (Good), based on 4 of 5 factors.
- Maintained: 100 (last commit 17 days ago)
- Popular: 49 (279 GitHub stars)
- Easy to install: 25 (1 install platform, install notes)
- Security check: 95 (no serious findings, CI, tests)

## Links

- Unraid: https://ca.unraid.net/apps/controlr-1xz153p1j2pgcp?q=ControlR
- GitHub: https://github.com/bitbound/ControlR
- Official website: https://controlr.app

## Common questions

### How do I supply the password and API key when deploying ControlR with Docker Compose?

Use the repository docker-compose files with either environment variables or Docker Secrets. For the Docker Secrets method, create the secret files and set appropriate permissions such as chmod 600.

### How do I configure ControlR for a reverse proxy or Cloudflare?

Set the required forwarded headers so each proxy hop is recorded, and make sure every proxy IP is trusted by the next hop in the chain. ControlR trusts the Docker gateway IP by default; you can enable EnableCloudflareProxySupport for Cloudflare IP ranges or add other proxy IPs to KnownProxies in the compose file.

### What port does ControlR use by default?

ControlR is available on port 5120 by default after deployment. You can verify startup by requesting /health, which should return Healthy.

### What should I do before upgrading ControlR?

Until ControlR reaches v1.0, minor versions may include breaking changes. Read the release notes for each version and follow any listed migration steps.

---
Source: Our Local Host (https://ourlocalhost.com/app/4285/controlr), the self-hosted and open-source app directory.
