Tutorials

Setting up Your Nuxeo Environment

Updated: February 22, 2017 Page Information Edit on GitHub

This how-to is the first step of the tutorial Getting Started with the Nuxeo Platform, allowing you to explore the Nuxeo Platform through its REST API. It provides instructions for installing and running a Nuxeo Platform instance using Docker, Homebrew or the ZIP package.

Docker

OS: Linux, Mac OS, Windows

Installation

  1. Install Docker: Follow the Docker Installation documentation.

  2. Download and start the Nuxeo Platform:

    $ docker run -ti --name mynuxeo -p 8080:8080 nuxeo/nuxeo:discover-lts
    
  3. Register your Nuxeo instance on Nuxeo Online Services:

    # You don't have a Nuxeo Online Service account
    $ docker exec -ti mynuxeo bin/nuxeoctl register-trial
    # OR
    # You already have a Nuxeo Online Service account
    $ docker exec -ti mynuxeo bin/nuxeoctl register
    

    And follow the instructions displayed.

Setting up Environment

You now have a Nuxeo Platform instance ready to run. At this step, you need to install some addons, in particular the addon Getting started with the Nuxeo Platform.

The addon Getting started with the Nuxeo Platform will add some business logic and documents to your Nuxeo Platform instance, that we will leverage all through this tutorial.

  1. Stop the server.

    $ docker exec mynuxeo bin/nuxeoctl stop
    
  2. Initialize local Nuxeo addons.

    $ docker exec mynuxeo bin/nuxeoctl mp-init
    
  3. Get the list of local Nuxeo addons.

    $ docker exec mynuxeo bin/nuxeoctl mp-list
    

    You get the list of local addons, whose status is downloaded.

  4. Install the addons required for this tutorial.

    $ docker exec -ti mynuxeo bin/nuxeoctl mp-install nuxeo-dam nuxeo-jsf-ui nuxeo-platform-getting-started
    
  5. Validate the dependency resolution step.

    Dependency resolution:
      Installation order (3):        nuxeo-dam-6.2.3/nuxeo-jsf-ui-8.10.0/nuxeo-platform-getting-started-1.1.0
      Packages to download (3):      nuxeo-jsf-ui:8.10.0, nuxeo-dam:6.2.3, nuxeo-platform-getting-started:1.1.0
    
    Do you want to continue (yes/no)? [yes]
    
  6. Check the Nuxeo addons were correctly installed.

    $ docker exec mynuxeo bin/nuxeoctl mp-list
    [...]
    Local packages:
     addon     started    nuxeo-dam (id: nuxeo-dam-6.2.3)
     addon     started    nuxeo-jsf-ui (id: nuxeo-jsf-ui-8.10.0)
     addon     started    nuxeo-platform-getting-started (id: nuxeo-platform-getting-started-1.1.0)
    

    The installed addons now have the status started.

  7. Start the server:

    $ docker exec mynuxeo bin/nuxeoctl start  
    [...]
    Server started with process ID 973.
    

    Your server is now running. You benefit from the following features brought by the addon Getting started with the Nuxeo Platform.

The addon brings the following document types:

  • The portfolio document type (BCPortfolio) holds the contracts of a customer. Its holds properties about the customer: the company name, industry and size, and the customer's juridical contact information.
  • The contract document type (BCContract) have several properties: an owner (an application user), some dates (signature, start, expiration dates), a type, an amount. It inherits customer information from its portfolio.
  • Some vocabularies are used to populate the portfolio and contract metadata (companySize, contractType and industry)
  • Contracts have a specific lifecycle, so they can evolve though the states draft, approval, running, renegociation, void, deleted and restored
  • Some business logic through automation chains and event handlers make contracts inherit properties from its portfolio, and evolve following its lifecycle

Homebrew

OS: Mac OS

Installation 

  1. Install Homebrew: Follow their documentation.
  2. Install the Nuxeo Platform:

    $ brew install nuxeo
    
  3. Register your Nuxeo instance on Nuxeo Online Services:

    # You don't have a Nuxeo Online Service account
    $ nuxeoctl register-trial
    # You already have a Nuxeo Online Service account
    $ nuxeoctl register
    

    And follow the instructions displayed.

Setting up Environment 

You now have a Nuxeo Platform instance ready to run. At this step, you need to install some addons, in particular the addon Getting started with the Nuxeo Platform.

The addon Getting started with the Nuxeo Platform will add some business logic and documents to your Nuxeo Platform instance, that we will leverage all through this tutorial.

To install a Nuxeo Package:

  1. Initialize local Nuxeo addons.

    $ nuxeoctl mp-init
    
  2. Get the list of local Nuxeo addons.

    $ nuxeoctl mp-list
    

    You get the list of local addons, whose status is downloaded.

  3. Install the addons required for this tutorial.

    $ nuxeoctl mp-install nuxeo-dam nuxeo-jsf-ui nuxeo-platform-getting-started
    
  4. Validate the dependency resolution step.

    Dependency resolution:
      Installation order (3):        nuxeo-dam-6.2.3/nuxeo-jsf-ui-8.10.0/nuxeo-platform-getting-started-1.1.0
      Packages to download (3):      nuxeo-jsf-ui:8.10.0, nuxeo-dam:6.2.3, nuxeo-platform-getting-started:1.1.0
    
    Do you want to continue (yes/no)? [yes]
    
  5. Check the Nuxeo addons were correctly installed.

    $ nuxeoctl mp-list
    [...]
    Local packages:
     addon     started    nuxeo-dam (id: nuxeo-dam-6.2.3)
     addon     started    nuxeo-jsf-ui (id: nuxeo-jsf-ui-8.10.0)
     addon     started    nuxeo-platform-getting-started (id: nuxeo-platform-getting-started-1.1.0)
    

    The installed addons now have the status started.

  6. Start the server

    $ nuxeoctl console
    

    Your server is now running. You benefit from the following features brought by the addon Getting started with the Nuxeo Platform.

The addon brings the following document types:

  • The portfolio document type (BCPortfolio) holds the contracts of a customer. Its holds properties about the customer: the company name, industry and size, and the customer's juridical contact information.
  • The contract document type (BCContract) have several properties: an owner (an application user), some dates (signature, start, expiration dates), a type, an amount. It inherits customer information from its portfolio.
  • Some vocabularies are used to populate the portfolio and contract metadata (companySize, contractType and industry)
  • Contracts have a specific lifecycle, so they can evolve though the states draft, approval, running, renegociation, void, deleted and restored
  • Some business logic through automation chains and event handlers make contracts inherit properties from its portfolio, and evolve following its lifecycle

Universal ZIP Package

OS: Linux, Mac OS, Windows

Contrarily to the Brew installation or Docker image, the universal ZIP package comes without the related software needed for this tutorial. Please install and set up related software before going to the next step.

Installation  

  1. Unzip the Nuxeo Platform .zip.
  2. Register your Nuxeo instance on Nuxeo Online Services:

    # Linux and Mac OS
    # You don't have a Nuxeo Online Service account
    $ ./$NUXEO_HOME/bin/nuxeoctl register-trial
    # You already have a Nuxeo Online Service account
    $ ./$NUXEO_HOME/bin/nuxeoctl register
    
    # Windows
    # You don't have a Nuxeo Online Service account
    $ .\$NUXEO_HOME\bin\nuxeoctl.bat register-trial
    # You already have a Nuxeo Online Service account
    $ .\$NUXEO_HOME\bin\nuxeoctl.bat register
    

    And follow the instructions displayed.

Setting up Environment  

You now have a Nuxeo Platform instance ready to run. In this step, you need to install some addons, in particular the addon Getting started with the Nuxeo Platform.

The addon Getting started with the Nuxeo Platform will add some business logic and documents to your Nuxeo Platform instance which we will leverage throughout this tutorial.

To install a Nuxeo Package:

  1. Initialize local Nuxeo addons.

    # Linux and Mac OS
    $ ./nuxeoctl mp-init
    
    # Windows
    $ .\nuxeoctl.bat mp-init
    
  2. Get the list of local Nuxeo addons.

    # Linux and Mac OS
    $ ./nuxeoctl mp-list
    
    # Windows
    $ .\nuxeoctl.bat mp-list
    

    You get a list of the local addons that have been downloaded.

  3. Install the addons required for this tutorial.

    # Linux and Mac OS
    $ ./nuxeoctl mp-install nuxeo-dam nuxeo-jsf-ui nuxeo-platform-getting-started
    
    # Windows
    $ .\nuxeoctl.bat mp-install nuxeo-dam nuxeo-jsf-ui nuxeo-platform-getting-started
    
  4. Validate the dependency resolution step.

    Dependency resolution:
      Installation order (3):        nuxeo-dam-6.2.3/nuxeo-jsf-ui-8.10.0/nuxeo-platform-getting-started-1.1.0
      Packages to download (3):      nuxeo-jsf-ui:8.10.0, nuxeo-dam:6.2.3, nuxeo-platform-getting-started:1.1.0
    
    Do you want to continue (yes/no)? [yes]
    
  5. Check that the Nuxeo addons were correctly installed.

    # Linux and Mac OS
    $ ./nuxeoctl mp-list
    [...]
    Local packages:
     addon     started    nuxeo-dam (id: nuxeo-dam-6.2.3)
     addon     started    nuxeo-jsf-ui (id: nuxeo-jsf-ui-8.10.0)
     addon     started    nuxeo-platform-getting-started (id: nuxeo-platform-getting-started-1.1.0)
    
    # Windows
    $ .\nuxeoctl.bat mp-list
    [...]
    Local packages:
     addon     started    nuxeo-dam (id: nuxeo-dam-6.2.3)
     addon     started    nuxeo-jsf-ui (id: nuxeo-jsf-ui-8.10.0)
     addon     started    nuxeo-platform-getting-started (id: nuxeo-platform-getting-started-1.1.0)
    

    The installed addons now have the status 'started'.

  6. Start the server.

    # Linux and Mac OS
    $ ./nuxeoctl console
    
    # Windows
    $ .\nuxeoctl.bat console
    

    Your server is now running with the addon Getting started with the Nuxeo Platform.

The addon brings the following document types:

  • The portfolio document type (BCPortfolio) holds the contracts of a customer. Its holds properties about the customer: the company name, industry and size, and the customer's juridical contact information.
  • The contract document type (BCContract) have several properties: an owner (an application user), some dates (signature, start, expiration dates), a type, an amount. It inherits customer information from its portfolio.
  • Some vocabularies are used to populate the portfolio and contract metadata (companySize, contractType and industry)
  • Contracts have a specific lifecycle, so they can evolve though the states draft, approval, running, renegociation, void, deleted and restored
  • Some business logic through automation chains and event handlers make contracts inherit properties from its portfolio, and evolve following its lifecycle

a month ago Manon Lumeau fix image on quick overview page
6 months ago Solen Guitter 54
6 months ago Bertrand Chauvin 53
6 months ago Solen Guitter 52
6 months ago Solen Guitter 51
6 months ago Solen Guitter 50
6 months ago Solen Guitter 49
6 months ago Arnaud Kervern 48
6 months ago Arnaud Kervern 47
6 months ago Solen Guitter 46
6 months ago Solen Guitter 45
7 months ago Bertrand Chauvin 44
7 months ago Solen Guitter 43
7 months ago Solen Guitter 42 | naming nuxeo container at dl&start step
7 months ago Solen Guitter 41
7 months ago Solen Guitter 40
7 months ago Solen Guitter 39
7 months ago Solen Guitter 38
7 months ago Solen Guitter 37
7 months ago Solen Guitter 36
7 months ago Solen Guitter 35
7 months ago Solen Guitter 34
7 months ago Solen Guitter 33
7 months ago Solen Guitter 32
8 months ago Solen Guitter 31
8 months ago Solen Guitter 30
8 months ago Solen Guitter 29
8 months ago Solen Guitter 28
9 months ago Solen Guitter 27
9 months ago Solen Guitter 26
9 months ago Solen Guitter 25
9 months ago Solen Guitter 24
10 months ago Solen Guitter 23
10 months ago Solen Guitter 22
10 months ago Solen Guitter 21
10 months ago Solen Guitter 20
a year ago Solen Guitter 19
a year ago Solen Guitter 18
a year ago Solen Guitter 17
a year ago Solen Guitter 16
a year ago Solen Guitter 15
a year ago Solen Guitter 14
a year ago Solen Guitter 13
a year ago Solen Guitter 12
a year ago Solen Guitter 11
a year ago Solen Guitter 10
a year ago Solen Guitter 9
a year ago Solen Guitter 8
a year ago Solen Guitter 7
a year ago Solen Guitter 5
a year ago Solen Guitter 6
a year ago Solen Guitter 4
a year ago Solen Guitter 3
a year ago Solen Guitter 2
a year ago Solen Guitter 1
History: Created by Solen Guitter