Remix is a browser-based compiler and IDE that enables users to build Ethereum contracts with Solidity language and to debug transactions.
To try it out, visit https://remix.ethereum.org.
https://github.com/ethereum/remix-project/releases also gives others ways to use Remix locally. Please check it out.
Remix consists of many modules and in this repository you will find Remix related apps, libs and plugins. (remix-ide, remix-analyzer, etc.).
gh-pages branch has always the latest stable build of Remix. It also contains a ZIP file with the entire build. Download it to use offline.
Note: It contains the latest release of Solidity available at the time of the packaging. No other compiler versions are supported.
Install npm and node.js (see https://docs.npmjs.com/getting-started/installing-node), then install Nx CLI globally to enable running nx executable commands.
npm install -g @nrwl/cli
clone the github repository (
wget need to be installed first) :
git clone https://github.com/ethereum/remix-project.git cd remix-project npm install nx build remix-ide --with-deps nx serve
If you want to run latest changes that are merged into master branch then run:
docker pull remixproject/remix-ide:latest docker run -p 8080:80 remixproject/remix-ide:latest
If you want to run latest remix-live release run.
docker pull remixproject/remix-ide:remix_live docker run -p 8080:80 remixproject/remix-ide:remix_live
To run locally without building you only need docker-compose.yaml file and you can run:
docker-compose pull docker-compose up -d
Then go to http://localhost:8080 and you can use you Remix instance.
To fetch docker-compose file without cloning this repo run:
curl https://raw.githubusercontent.com/ethereum/remix-ide/master/docker-compose.yaml > docker-compose.yaml
nx serve and open
http://127.0.0.1:8080 in your browser.
Then open your
text editor and start developing.
The browser will automatically refresh when files are saved.
Some things to consider if you have trouble building the package:
nvm. Also ensure you have Nx CLI installed globally. You can find the version that is tested on Travis CI by looking at the log in the build results.
node --version npm --version nvm --version
apt-get install build-essential. After installing
Run the unit tests via:
nx test <project-name>
nx test remix-analyzer
Running unit tests via
nx test requires at least node v10.0.0
To run the Selenium tests via Nightwatch:
Build Remix IDE and serve it:
nx build remix-ide --with-deps && nx serve # starts web server at localhost:8080
Make sure Selenium is installed
npm run selenium-install # don't need to repeat
Run a selenium server
npm run selenium
Run all the tests
npm run nightwatch_local_firefox or
npm run nightwatch_local_chrome
Or run a specific test case:
- npm run nightwatch_local_ballot - npm run nightwatch_local_usingWorker - npm run nightwatch_local_libraryDeployment - npm run nightwatch_local_solidityImport - npm run nightwatch_local_recorder - npm run nightwatch_local_transactionExecution - npm run nightwatch_local_staticAnalysis - npm run nightwatch_local_signingMessage - npm run nightwatch_local_specialFunctions - npm run nightwatch_local_solidityUnitTests - npm run nightwatch_local_remixd # remixd needs to be run - npm run nightwatch_local_terminal - npm run nightwatch_local_gist - npm run nightwatch_local_workspace - npm run nightwatch_local_defaultLayout - npm run nightwatch_local_pluginManager - npm run nightwatch_local_publishContract - npm run nightwatch_local_generalSettings - npm run nightwatch_local_fileExplorer - npm run nightwatch_local_debugger - npm run nightwatch_local_editor - npm run nightwatch_local_compiler - npm run nightwatch_local_txListener - npm run nightwatch_local_fileManager - npm run nightwatch_local_runAndDeploy
ballot tests suite requires to run
remixd tests suite requires to run
gist tests suite requires specifying a github access token in .env file.
gist_token = <token>
note that this token should have permission to create a gist.
To see details about how to use Remix for developing and/or debugging Solidity contracts, please see our documentation page