Skip to main content

Quickstart

  1. Run below command on Linux/Mac to start OneDev in docker mode:

    docker run -it --rm -v /var/run/docker.sock:/var/run/docker.sock -v $(pwd)/onedev:/opt/onedev -p 6610:6610 -p 6611:6611 1dev/server

    If you want to try on Windows machine, please follow the bare metal installation guide

  2. Point your browser to http://localhost:6610 to set up OneDev, and then create a project with name my-app

  3. Run below command from your terminal to create a react application:

    npx create-react-app my-app
  4. Change into directory my-app, and run below command to push code to OneDev:

    git remote add origin http://localhost:6610/my-app
    git push origin main:main

    When prompted for authentication, input administrator user name and password specified above

  5. Navigate to the OneDev project, click link adding .onedev-buildspec.yml to bring up the GUI to set up CI/CD

    Set Up CI/CD

  6. For typical projects, OneDev suggests default CI/CD job templates like below:

    Add Job Wizard

  7. Just use the default template, and save the build spec. Now you will see that a CI build is running:

    After Add Ci Job

  8. Congrats! You've finished the quickstart. Continue to check some tutorials if you are interested.