dedrisdev/code-workspace repository overview

⁠DedrisDev/code-workspace

⁠Overview

DedrisDev/code-workspace is a self-hosted cloud development environment that provides a powerful alternative to GitHub Codespace and Google IDX Project. This Docker container includes a modified version of code server, offering a comprehensive development environment accessible from any device with a browser.

⁠Features

• Automatic Repository Pull: Automatically pulls your private GitHub repository using a token passed through environment variables.
• Universal Compatibility: Access your development environment from any device, including Raspberry Pi, iPad, Chromebook, and even consoles like Xbox.
• Advanced Code Server: Enjoy all the advanced features of code server, tailored to meet modern development needs.
• Secure and Flexible: Full control over your environment with enhanced security measures and customizable settings.

⁠Usage

To pull the Docker image, use the following command:

docker pull dedrisdev/code-workspace

⁠Running the Container

Launch the container with your specific environment variables:

docker run -d
--name workspace-001 
-e REPO_URL=https://github.com/YOUR_PRIVATE_REPO 
-e WORKSPACE_PASSWORD=YOUR_PASSWORD 
-e REPO_TOKEN=YOUR_GITHUB_TOKEN_CLASSIC 
-e GIT_USER_NAME=YOUR_GIT_USERNAME 
-e GIT_USER_EMAIL=YOUR_GIT_EMAIL 
-p 8080:8080 
dedrisdev/code-workspace

⁠Environment Variables

• REPO_URL: URL of your private GitHub repository.
• WORKSPACE_PASSWORD: Password for accessing the code server.
• REPO_TOKEN: GitHub token classic for repository access. (Get here https://github.com/settings/tokens⁠)
• GIT_USER_NAME: Git username for commits.
• GIT_USER_EMAIL: Git email for commits.

⁠Getting Started

1. Pull the Docker Image: Use the following command to pull the Docker image:

    docker pull dedrisdev/code-workspace

1. Run the Container: Execute the command below, replacing the placeholders with your specific details:

    docker run -d
    --name workspace-001
    -e REPO_URL=https://github.com/YOUR_PRIVATE_REPO 
    -e WORKSPACE_PASSWORD=YOUR_PASSWORD
    -e REPO_TOKEN=YOUR_GITHUB_TOKEN
    -e GIT_USER_NAME=YOUR_GIT_USERNAME
    -e GIT_USER_EMAIL=YOUR_GIT_EMAIL
    -p 8080:8080
    dedrisdev/code-workspace

1. Access the Environment: Open your browser and navigate to http://localhost:8080 (or the appropriate address) to start coding.

⁠Conclusion

DedrisDev/code-workspace offers a robust, flexible, and secure cloud development environment for developers looking for a self-hosted solution. With universal device compatibility and advanced features, it's the perfect tool for modern software development.