Setting the Server Name

peter.grainger · 3 May 2021 21:34

I’m deploying the server and I saw there is a table with server information.

specklesystems/speckle-server/blob/2314917b304f5f5626360ab1dbe14ad53cd505ca/packages/server/modules/core/migrations/000-core.js#L11

    
      
          /* istanbul ignore file */
          'use strict'
          
          
// Knex table migrations
          exports.up = async knex => {
            await knex.raw( 'CREATE EXTENSION IF NOT EXISTS "pgcrypto"' )
          
          
  // Base table holding up some configuration variables for the server. Not really used much.
            await knex.schema.createTable( 'server_config', table => {
              table.integer( 'id' ).notNullable( ).defaultTo( 0 ).index( )
              table.string( 'name' ).defaultTo( 'Community Server' )
              table.string( 'company' ).defaultTo( 'Unknown Company' )
              table.string( 'description' ).defaultTo( 'This a community deployment of a Speckle Server.' )
              table.string( 'adminContact' ).defaultTo( 'n/a' )
              table.string( 'termsOfService' ).defaultTo( 'n/a' )
              table.string( 'canonicalUrl' )
              table.boolean( 'completed' ).defaultTo( false )
            } )
          
          
  await knex( 'server_config' ).insert( { id:0 } )

What is the best way to update the server_config table so the server name, company, etc are updated?

AlanRynne · 3 May 2021 21:38

Hey @peter.grainger, not sure about the backend details of this. But if its your server (aka, you’re the first user created), you should be allowed to change this in the front end.

Just go to your profile page, and you should have an edit button in the Server Details to modify them.

peter.grainger · 3 May 2021 21:42

Thanks @AlanRynne , I’ve found it!

Was wondering how Admin worked…

AlanRynne · 3 May 2021 21:55

hehe I was just checking the API while you answered.

In the GraphQL api, there’s a serverInfoUpdate mutation. It takes an info object that contains the fields you’re looking for

You can check the explorer of your server appending /explorer to your server’s url, or through the profile page. Using the explorer is quite neat as it already attaches your auth token, so it makes exploring the api quite fast.