Volto can be installed in any operating system assuming that the requirements are met:
Depending on the OS that you are using some of the following might change, they are assuming a MacOS/Linux machine:
Install nvm (NodeJS version manager)#
Open a terminal console and type:
$ touch ~/.bash_profile $ curl -o- https://raw.githubusercontent.com/creationix/nvm/v0.34.0/install.sh | bash
Close the terminal and open a new one or execute:
$ source ~/.bash_profile
$ nvm version
Install latest NodeJS 10.x:
$ nvm install 10.15.1 $ nvm use 10.15.1
$ node -v
Yarn (NodeJS package manager)#
Install the node package manager.
Open a terminal and type:
$ curl -o- -L https://yarnpkg.com/install.sh | bash
Test it, running:
$ yarn -v
You can install
yarn using several approaches too, depending on the
platform you are on. Take a look at the original
documentation for a list of them.
Docker for Mac#
In order to run the API backend, it's better to start running it in a container.
Here are the detailed instructions:
Download the .dmg from:
Install the package as any other Mac software, if required, follow instructions from:
Check that docker is installed correctly, open a new terminal and type:
$ docker ps
should not throw an error and show the current running containers.
Run a Volto ready Plone Docker container#
We need Plone meet some requirements in order to fully support Volto.
There's a package
kitconcept.voltodemo that does all the heavy lifting for you.
You can run an standard Plone docker container with the proper configuration using
kitconcept.voltodemo right away by issuing:
$ docker run -it --rm --name=plone -p 8080:8080 -e SITE=Plone -e ADDONS="kitconcept.voltodemo" -e ZCML="kitconcept.voltodemo.cors" plone
- Open a terminal and execute:
$ npm -g i @plone/create-volto-app
Optionally, you can also use
npx utility to install
without having to install it globally. On the other hand, in order to do it, you
have to install
npx globally. The advantage is that you don't have to
create-volto-app each time you want to use it, because
it for you:
npx @plone/create-volto-app myvoltoapp
Create a new Volto app using the recently added command, providing the name of the new app (folder) to be created.
$ create-volto-app myvoltoapp
Change directory to the newly created folder
myvoltoapp(or the one you've chosen). Then
$ yarn start
Volto should compile and be executed in development mode. Open a browser to take a look at http://localhost:3000
Compile the production build#
In production enviroments, you can compile an static version of the app. The app should be run in a node process (because of the server side rendering part), but also have a client part that is provided and deployed by the server side rendering process.
Compile the app using the command:The resultant build is available in the
$ yarn build
Run the Volto Nodejs process
$ yarn start:prod
to run the node process with the production build. You can also run it manually:
$ NODE_ENV=production node build/server.js